home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / rtmon-run.z / rtmon-run
Encoding:
Text File  |  2002-10-03  |  5.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. RRRRTTTTMMMMOOOONNNN----RRRRUUUUNNNN((((1111))))                                                      RRRRTTTTMMMMOOOONNNN----RRRRUUUUNNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrrttttmmmmoooonnnn----rrrruuuunnnn - enable system call event tracing
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rtmon-run ----cccc _c_o_o_k_i_e [ ----iiii ] [ ----pppp _p_i_d ] [ ----tttt _s_e_c_s ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      rrrrttttmmmmoooonnnn----rrrruuuunnnn is used in conjuction with rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt(1) to collect system
  16.      call and context switch events from a remote machine.  rrrrttttmmmmoooonnnn----rrrruuuunnnn marks
  17.      one or more processes for system call and context switch event tracing
  18.      and then pauses waiting for an interrupt or a time limit to expire.  If
  19.      no processes are specified on the command line, the entire system is
  20.      monitored.  Event collection must be done separately; typically from
  21.      another machine with the rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt application.  rrrrttttmmmmoooonnnn----rrrruuuunnnn must be run
  22.      on the machine where the processes to be traced are located because it
  23.      must access the ////ddddeeeevvvv////ppppaaaarrrr special file to enable system call and context
  24.      switch tracing for the processes.  rrrrttttmmmmoooonnnn----rrrruuuunnnn is normally not needed; the
  25.      ppppaaaarrrr(1) and ppppaaaaddddcccc(1) programs are the preferred means for collecting event
  26.      traces.  The only reason to use rrrrttttmmmmoooonnnn----rrrruuuunnnn instead of ppppaaaaddddcccc is to avoid any
  27.      overhead associated with running ppppaaaaddddcccc on the system where data is to be
  28.      collected.
  29.  
  30. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  31.      ----cccc _c_o_o_k_i_e
  32.           Use _c_o_o_k_i_e when enabling system call tracing for the specified
  33.           processes.  A cookie is a magic number that is used by rrrrttttmmmmoooonnnndddd(1) to
  34.           determine which client programs may receive system call event data.
  35.           The cookie to pass to rrrrttttmmmmoooonnnn----rrrruuuunnnn is obtained by specifying the ----vvvv
  36.           option when starting rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt(1).  The rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt program must
  37.           be started before running rrrrttttmmmmoooonnnn----rrrruuuunnnn in order to obtain a valid
  38.           cookie to supply as a parameter to the ----cccc option.
  39.  
  40.      ----iiii   Inherit system call event tracing to future children of the
  41.           specified processes.
  42.  
  43.      ----rrrr   This option marks the specified processes for collection of context
  44.           switch events.  If no processes are specified, all processes which
  45.           you have access privileges will be marked.  This option is really
  46.           only useful when used with the ttttaaaasssskkkkpppprrrroooocccc event mask class of rrrrttttmmmmoooonnnn----
  47.           cccclllliiiieeeennnntttt since the ttttaaaasssskkkk event class can be used collect context switch
  48.           events for all execution threads without the use of rrrrttttmmmmoooonnnn----rrrruuuunnnn.
  49.  
  50.      ----ssss   This option marks the specified processes for collection of system
  51.           call events.  Since this is the default it serves the sole purpose
  52.           of preventing needless complaints from rrrrttttmmmmoooonnnn----rrrruuuunnnn when a user
  53.           absent-mindedly types in ----ssss while thinking in terms of ppppaaaaddddcccc/ppppaaaarrrr...
  54.  
  55.      ----pppp _p_i_d
  56.           Enable system call tracing for the process _p_i_d.  This option may be
  57.           used multiple times to enable tracing of multiple processes.
  58.           Processes specified with this option must belong to the current user
  59.           unless the user has super-user privilege.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRTTTTMMMMOOOONNNN----RRRRUUUUNNNN((((1111))))                                                      RRRRTTTTMMMMOOOONNNN----RRRRUUUUNNNN((((1111))))
  71.  
  72.  
  73.  
  74.      ----tttt _s_e_c_s
  75.           Collect tracing information for _s_e_c_s seconds before terminating.  If
  76.           this option is not specified then rrrrttttmmmmoooonnnn----rrrruuuunnnn will pause until it is
  77.           interrupted from the keyboard or by receiving a signal.
  78.  
  79. FFFFIIIILLLLEEEESSSS
  80.      _////_dddd_eeee_vvvv_////_pppp_aaaa_rrrr    for enabling system event tracing
  81.  
  82. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  83.      _pppp_aaaa_rrrr(1), _pppp_aaaa_dddd_cccc(1), _rrrr_tttt_mmmm_oooo_nnnn_----_cccc_llll_iiii_eeee_nnnn_tttt(1), _rrrr_tttt_mmmm_oooo_nnnn_dddd(1), _pppp_aaaa_rrrr(7).
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.